• The best villains in literature (This week in books)

    Updated: 2025-03-08 01:14:32
    This week! Books! (A bit delayed and abbreviated because I’m on the road). LitHub’s annual counter-programming to the March Madness basketball tournament is here, and this year it’s a villainous one: who is the best villain in literature? Cast your votes! I, for one, feel Long John Silver as a 15 seed is an upset […]

  • There was s*** going on before you got here

    Updated: 2025-03-03 21:39:43
    David Lynch’s recent passing inspired me to revisit my favorite of his movies, Mulholland Drive, which I hadn’t seen since I first watched it in a theater in 2001. Of course it holds up. Of course it’s heads and shoulders above nearly anything else made this century. What struck me watching it this time was […]

  • Do developers need code samples in API documentation?

    Updated: 2025-03-02 08:00:00
    Although code samples have long been a staple in API documentation, I'm not sure users need them that much. Many developers now use AI tools that can generate the same basic code samples that are commonly provided in documentation. If these same developers pass in either the source files or reference documentation, AI tools can generate the code samples they need in the language they want, and better yet, tailored to their project and business context.

  • Is the end near for mass market paperbacks? (This week in books)

    Updated: 2025-02-28 20:00:00
    This week! Books! Could the end be near for mass market paperbacks, the small book format that has populated many a supermarket rack over the years? Mass market paperbacks have declined to 3% of all book sales, profit margins were always slim, and distributor Readerlink will stop shipping them at the end of 2025. According […]

  • Submissions are now closed for the 2024/2025 Lindenbaum competition

    Updated: 2025-02-28 16:27:00
    : Lloyd of Gamebooks A blog about writing gamebooks . My musings on how to write a gamebook and what makes a good gamebook . Create your story here Friday , February 28, 2025 Submissions are now closed for the 2024 2025 Lindenbaum competition Hello all Submissions have now closed for the 2024 2025 Lindenbaum . competition I am excited to say that we have 16 entries for this year's competition . nbsp The entries will be made available on the 10th March when voting opens . nbsp Votes need to be sent to lindenbaumprize gmail.com Each voter must submit 3 books . If they submit less than 3, their votes won't count . If they submit more than 3, the first 3 will . count As there are 16 entries , I have extended the voting deadline to the 31st May . The winners will be announced on the 10th . June

  • Stamp out vague catchalls in your writing

    Updated: 2025-02-24 20:00:00
    Here’s a near-ironclad maxim that’s worth taping above your laptop: You’re a more confusing writer than you think you are. You know exactly what your words mean. You can visualize every scene you write in vivid detail no matter how scant your physical description may be. Writers inevitably project details onto the page that aren’t […]

  • Fixing bugs without thinking, Recursive Self-Improvement, and the shift towards more complex tech comm tasks

    Updated: 2025-02-24 08:00:00
    This post includes a mix of various thoughts on AI, including fixing bugs without thinking, competitive pressures to adopt AI workflows, risks of atrophied critical thinking, recursive self improvement, and the shift toward more complex tech comm tasks. There's not necessarily an argument throughline here, just various thoughts and perspectives on AI topics in my tech comm world.

  • Rethinking traditional approaches to release notes -- recording of WTD Australia presentation

    Updated: 2025-02-17 08:00:00
    I gave a presentation to the Write the Docs Australia group on using AI to write release notes using file diffs, on Feb 16, 2025. Here's the recording, presentation description, and transcript.

Previous Months Items

Feb 2025 | Jan 2025 | Dec 2024 | Nov 2024 | Oct 2024 | Sep 2024